Extracts state information from a suspended task.
OSStatus MPExtractTaskState (
MPTaskID task,
MPTaskStateKind kind,
void *info);
task
A value of type MPTaskID
that specifies the task whose state information you want to obtain.
kind
A value of type MPTaskStateKind
that specifies the kind of state information you want to obtain. See
Task State Constants
for a listing of possible values.
info
A pointer to a data structure to hold the state information. On return, the data structure holds the desired state information. The format of the data structure varies depending on the state information you want to retrieve. See the header file MachineExceptions.h
for the formats of the various state information structures.
function result
A result code. See
Result Codes
for a list of possible values. If you attempt to extract state information for a running task, this function returns kMPInsufficientResourcesErr
.
DISCUSSION
You can use this function to obtain register contents or exception information about a particular task.
